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A NON PROFIT ORGANIZATION 


~~ EDITOR'S COMMENTS * 4) / 2 


FRONT COVER 
JASON OAKLEY HAS BEEN BUSY ON THE FRONT COVER ONCE MORE. AGAIN IT RELATES TO 


AN ARTICLE INSIDE. THANKS JASON. 
HELP — SELL & TELL PAGE 5 


Vz BUS MOUSE PART I BY L MILBURN PAGES 4-5 

THE FIRST PART OF THE SECOND MOUSE PROJECT FOR THE VZ. LESLIE'S VERSION 
DIFFERS IN THAT NO MODS ARE REQUIRED TO THE BUS MOUSE, BUT IT'S A BIT MORE 
EXPENSIVE THAN A SERIAL MOUSE. 


KSCAN PT ITT BY LESLIE MILBURN PAGES 6-7 
THE FINAL PART ON KSCAN. DUE TO THE SIZE OF THE SOURCE CODE IT WILL NOT BE 
PUBLISHED IN THE JOURNAL. READ EDITOR'S COMMENTS ON PAGE 7 FOR MORE DETAILS. 


EXTENDED DOS V12.1 BY L_MILBURN PPAGES 8S—1 1 
THE FIRST PART HAS THE INSTRUCTIONS PLUS HALE THE SOURCE CODE. EXT1I2.1 IS A 
VERY USEFUL UTILITY WITH SOME WELCOME FUNCTIONS. 


DISKOPS 1 & 2 INSTRUCTIONS PAGE 12 
I BELIEVE THIS MAY SE THE FIRST IN A SERIES OF INSTRUCTIONS FOR LESLIE 
MILBURN'S DISKOP EDITOR ASSEMBLERS. 


ASSEMBLY LANGUAGE PART LIL PAGES 13-15 
BY BOB KITCH 
PART 3 FEATURES LISTING 5 AND FUNCTIONS IN BASIC. 


TECHNICAL DATA SHEET # 1 PAGES 15-16 
THE FIRST IN A SERIES OF TECHNICAL DATA SHEETS FOR THE VZ. DISK DRIVE POWER 
SUPPLY AND WORDPRO CARTRIDGE CIRCUITS ARE PROVIDED. 


DRIVE HEAD PARK UPDATE PAGE 17 


GARY BULLEY VZ MOUSE ERRATTA PAGE 17 
EAGLE EYED GARY HAS SPOTTED SOME OF THE MISTAKES THAT CREPT IN AND PROVIDED 
CORRECTIONS TO THEM. 


TECHNICAL DATA SHEET # Zz PAGE 183 
STATIC RAM AND VZ ROM PINOUTS AND BLOCK DIAGRAMS ARE SHOWN. 


DAVE MITCHELL SOFTWARE FOR SALE PAGE 19 
PATCHS .3 — EXT DOS & MENU/FILE COPTER 


PETER HICKMAN SOFTWARE FOR SALE PAGE 19 
VZ MODEM & M/C DISASSEMLER 


USER GROUPS * NEWS “ SUBSCRIPTIONS PAGE 202 


OISCLAIMER:  EveRY EFFORT IS MADE TO INSURE THE ACCURACY OF INFORMATION 
CONTAINED WITHIN 8E IT GENERAL, TECHNICAL, PROGRAMMING, ETC. NO RESPONSIBILITY 
CAN BE ACCEPTED BY HUNTER VALLEY VZ USERS’ GROUP OR AUTHOR AS A RESULT OF APPLY ING 
SUCH INFORMATION IN PRACTICE. 


COPYRIGHT: THE HUNTER VALLEY VZ JOURNAL IS SUBJECT TO COPYRIGHT AND NO 
MATERTAL IN THE JOURNAL MAY BE REPRODUCED IN PART OR WHOLE WITHOUT THE CONSENT OF 
THE HUNTER VALLEY USERS’ GROUP OR THE AUTHOR WHO RETAINS COPYRIGHT. 


“we KYW HELP 7 SELL & TELL * © 40/35 


APOLOGTIES: 


[ STARTED JOURNAL EARLY JULY WHEN THINGS GOT WORSE MEDICALLY. My 
CONTINUING MEDICAL PROBELM IS THE RESULT OF THE CAR ACCIDENT OVER 4 
YEARS AGO WHICH AFFECTED MY SPINE AND EVERY JOINT IN MY gSopyY. THE 
CHRONIC PAINS ARE USUALLY AT A BEARABLE LEVEL, BUT THE WINTER JUST 
PASSED HAS NOT HELPED. 


TO COMPOUND THE PROBLEM, PAIN KILLERS GIVE NO RELIEF AT ALL. THE 
ONLY THING THAT REDUCES THE CHRONIC PAINS IS LYING DOWN SEVERAL TIMES 
A DAY WHICH TAKES A BIG CHUNK OUT OF THE DAY. IN THE EVENT OF THE 
JOURNAL CEASING PRODUCTION OUTSTANDING SUBSCRIPTIONS WOULD BE REFUNDED 
AS THE CLUB'S FUNDS ARE QUITE SOUND. 


IT IS MY INTENTION TO PRUDUCE THE JOURNAL FOR SOME TIME TO COME AS 
THERE IS STILL A LOT OF LIFE LEFT IN THE HUMBLE VZ. IT GIVES ME A 
GREAT DEAL OF PLEASURE IN PRUODUCING THE JOURNAL AND BEING PART OF A 
GROUP OF PEOPLE AUSTRALIA WIDE. 


GET WELL SOON NEVILLE : 


ON BEHALF OF THE HUNTER VALLEY VZ USER'S GROUP AND MYSELF WE WISH 
NEVILLE HUGHES A SPEEDY RECOVERY FROM 3 VERY BAD HEART ATTACKS. KEEP 
UP THE GOOD FIGHT NEVILLE AND WE LOOK FORWARD TO YOUR NEXT PROJECT. 


TECHNICAL DATA SHEETS: 


[ WOULD LIKE YOUR OPINION ON THE DATA SHEETS AS I INTEND THEM TO 
BECOME A REGULAR ITEM IN THE JOURNAL. IF YOU HAVE A CONTRIBUTION OR 
IDEAS FOR THEM, THEN PLEASE LET ME KNOW, ED. 


FOR SALE — IBM MOTHERBOARD : 


A COUPLE WEEKS AGO I INSTALLED AN UP-GRADEABLE 386DX MOTHERBOARD 
WITH 4M RAM IN MY IBM COMPATIBLE PC. NEEDLESS TO SAY THE OLO 
MOTHERBOARD IS NO LONGER REQUIRED AND I OFFER IT FOR SALE. 


| OFF BaBy AT 286 MOTHERBOARD - 6/12 MHZ 
1 MEG RAM AND MATHS CO-PROCESSOR ON BOARD 

RAM EXPANDABLE TO 4M USING 4 X 1M SIpps 
| OFF INSTRUCTION MANUAL 


PRICE: $15@.@@ ONO- INCLUDES PosT & PACKING — CONTACT: 
JOSEPH P LEON - PHONE (049) 692-399 - 33 TIGHES TcE TIGHES HILL 2297 


NEx<T ISSUE  ; 


IT IS MY INTENTION TO PRODUCE ANOTHER ISSUE AND HAVE IT POSTED OUT 
BEFORE CHRISTMAS 1992 AND HOPEFULLY KEEP TO A BI-MONTHLY SCHEDULE. 
BELOW ARE SOME OF THE PROPOSED MATERIAL FOR NEXT ISSUE. 


1) LISTING OF PUBLIC DOMAIN PROGRAMS. 

2) LISTING OF PUBLIC DOMAIN SOURCE CODE. 

3) ARTICLE ON EDITOR/ASSEMBLER INCOMPATIBILITY. 

4) TECHNICAL DATA SHEET # 4, (5-67). 

5) PLUS CONTINUATION OR CONCLUSION OF PARTLY PUBLISHED MATERIAL. 


VZ BUS MOUSE PROJECT PART 1 40/4 
BY LESLIE MILBURN 


THIS PROJECT IS AN ALTERNATIVE TO THE MOUSE PROJECT PRESENTED IN 
THE LAST JOURNAL AND ALLOWS A MOUSE TO BE CONNECTED WITHOUT 
MODIFICATIONS TO THE VZ. ALL MICE WORK ROUGHLY THE SAME WAY SO I 
SHALL NOT REPEAT HERE WHAT WAS DESCRIBED IN GARY BULLEY’S ARTICLE. 
THERE ARE TWO TYPES OF MOUSE:- 


(1) A SERIAL MOUSE - THIS IS THE MOST COMMON TYPE OF MOUSE AND HAS AN 
RSZ32C INTERFACE. THIS CAN HAVE EITHER A DB9 oR DB25 CONNECTOR. THIS 
IS THE TYPE OF MOUSE WHICH CAN BE MODIFIED FOR THE VZ USING GARY'S 
METHOD. AN ALTERNATIVE SOLUTION IS TO BUILD AN RS?32 PORT FOR THE V7 
AND PLUG IT IN DIRECTLY. 


(4) A BUS MOUSE - THIS TYPE OF MOUSE IS USED BY THE AMIGA, AMSTRAD, 
ATARI AND SOME IBM CLONES SUCH AS THE COMMODORE PC COLT, PC1I@ & PCZM 
AND NOW THE VZ. THE PLUG ON THIS TYPE OF MOUSE IS A DBS PLUG. FOR 
THOSE WHO NEED HELP FINDING A SUITABLE MOUSE THERE IS ONE AVAILABLE 
FOR $50-@@ (APPROX) FROM GRACE BRos. IT IS A QTRONIX MOUSE FOR THE 
AMIGA 580/1@00@/2@00, SERIAL NUMBER X3@0B (Bus VERSION). HOWEVER, SHOP 
AROUND AS I'M SURE THAT YOU CAN BUY THEM CHEAPER. 


FOR EACH OF THESE MICE, A TWO BUTTON AND THREE BUTTON VERSION EXISTS. 


THE HARDWARE: -— 

TO CONNECT A BUS MOUSE TO THE VZ, THE 8 BIT INPUT PORT AS 
DESCRIBED IN JOURNAL #3@ IS REQUIRED. THE PIN DEFINITIONS ARE AS 
FOLLOWS: - 


PIN — DESCRIPTION DATA LINE 
1 -— VERTICAL MOTION - D@ 
2 - HORIZONTAL MOTION - D1 
3 VERTICAL MOTION 9@ DEG. ouT = DZ 

OF PHASE OF 1, 
4 - HORIZONTAL MOTION 9@ DEG. ouT - D3 
OF PHASE OF 2, 
5 - MOUSE BUTTON 3 (OPTIONAL) - D4 
6 —- MOUSE BUTTON 1 = 5 
/ - +5 VOLTS - N/A 
& — GROUND - N/A 
9 — MOUSE BUTTON 2 ~ D6 


AS CAN BE SEEN ABOVE, SOME MODIFICATIONS TO THE INPUT POFT MUST BE 
MADE. THE CHANGES I MADE WERE TO USE A DBO SOCKET AND CONNECT THE 
PINS AS SHOWN ABOVE. D/7 MUST BE CONNECTED TO GROUND, THIS T§ REQUIRED 
SOQ THAT THE MOUSE DRIVER CAN DETECT THE PRESENCE OF THE MOUSE PORT. 


WARNING: WHEN CONNECTING THE 8 BIT INPUT PORT TO THE PRINTER 
INTERFACE, CHECK WHICH VERSION OF THE INTERFACE YOU HAVE. THIS IS 
BECAUSE SOME INTERFACES USE A4 TO TRIGGER THE 74LS5138 NoT AQ. 


THIS MEANS THAT ALTHOUGH THE PRINTER IS ACCESSED WHEN A4 IS LOW 
(I.E. PORTS @ - 15), THE INPUT PORT IS ACCESSED WHEN Ad IS HIGH (I.E. 
PORTS 16 ~ 31). THIS CAUSES ADDRESS CONFLICT WITH THE DISK SYSTEM. 
ALSO NOTE THAT THIS VERSION OF THE INTERFACE IS NOT IN THE VZ 
TECHNICAL MANUAL. BE CAREFUL! ! 


THE MouseE DRIVER: — 


THE VZ MOUSE DRIVER IS AN INTERRUPT DRIVEN MACHINE CODE PROGRAM 
WHICH INTERPRETS THE RAW DATA SENT TO THE VZ BY THE MOUSE. THIS RAW 
DATA INDICATES MOUSE MOVEMENT AND BUTTON PRESSES. 


VZ BUS MOUSE PROVUVECT CONT. 4A0/5 


THE MAIN AIM OF THIS PROJECT IS TO PROVIDE MOUSE FACILITIES 
EQUIVALENT TO THOSE ON AN IBM PC. THE LATEST MICROSOFT MoUSE DRIVER 
(VERSION 8.@) PROVIDES 53 FUNCTION CALLS THAT LET PROGRAMS PERFORM 
SPECIFIC TASKS, SUCH AS CHECKING A MOUSE BUTTON. THE VZ MOUSE DRIVER 
PROVIDES ALMOST THE WHOLE SUITE OF MOUSE FUNCTIONS. 


THE MOUSE DRIVER CAN BE BROKEN INTO THREE DISTINCT PARIS .= 


(1) THE INTERRUPT ROUTINE, 
(2) THE MOUSE FUNCTION LIBRARY, 
(3) THE BASIC MOUSE FUNCTION. 


NOTE: 


(I) VERSION 1.@3 OF THE VZ MOUSE DRIVER ONLY SUPPORTS TEXT MODE (@) . 
(II) THIS VERSION OF THE MOUSE DRIVER SUPPORTS A MOUSE CURSOR WHICH I5 
INDEPENDENT OF THE KEYBOARD CURSOR. 


THE INTERRUPT ROUTINE: - 


EVERYTIME AN INTERRUPT OCCURS THIS ROUTINE MUST BE CALLED. IT 
LOOKS AFTER THE POLLING OF THE MOUSE AND MAINTENANCE OF ALL MOUSE 
"VARIABLES", THE MORE TIMES THE MOUSE IS POLLED, THE MORE SENSITIVE 
THE MOUSE CURSOR MOVEMENT. THE NUMBER OF TIMES THE MOUSE IS POLLED 
CAN BE SET BY A PROGRAM. 


THE MOUSE FUNCTION LIBRARY:-— 


AS MENTIONED ABOVE, THERE ARE 53 IBM MOUSE FUNCTIONS. NOT ALL 
FUNCTIONS ARE PROVIDED IN V1.03 OF THIS DRIVER. THESE FUNCTIONS ARE 
DOCUMENTED IN TWO READILY AVAILABLE BOOKS:- 


(1) THe MICROSOFT MoUSE PROGRAMMERS REFERENCE - %$65-@@ FROM DYMOcK: 
(2) THE DOS PROGRAMMERS REFERENCE - $6@0-0@ (APPROX) ALSO FROM DYMOCKS. 


IN THE NEXT VJOURNAL I SHALL DESCRIBE EACH OF THE AVAILABLE 
FUNCTIONS IN DETAIL. 


THE BASIC MOUSE FUNCTION:- 


TO ALLOW THE BASIC PROGRAMMER EASY ACCESS TO THE MOUSE FUNCTION 
LIBRARY, A NEW BASIC COMMAND HAS BEEN PROVIDEG. THE SYNTAX OF THIS 
COMMAND IS:- 


MOUSE (M1%, M2%, M3%, MA4%). 


M1IZ IS THE MOUSE FUNCTION NUMBER. 
M2% - M4% ARE PARAMETERS TO THE MOUSE FUNCTIONS. 


NOTE: NOT ALL PARAMETERS ARE USED BY ALL MOUSE FUNCTIONS BUT THEY MUST 
STILL BE PROVIDED IN THE CALL. 


THE NEW COMMAND MAY BE CALLED FROM WITHIN A BASIC PROGRAM OR IN 
IMMEDIATE MODE. ALTHOUGH YOU MAY USE INTEGER CONSTANTS AND VARIABLES 
TO CALL MOUSE FUNCTIONS, RETURN VALUES ARE PASSED BACK TO THE PROGRAM. 

THESE RETURN VALUES WILL ALWAYS BE STORED IN THE VARIABLES M1%, M2%, 
M3% AND M4%, AND AS SUCH PROGRAMS SHOULD AVOID STORING DATA IN THESE 
VARIABLES, 


To BE CONTINUED ........ 


GOOG 1 
GOOB2 
8003 
Q0GG4 
08885 
00006 
GOBQ7 
QQ088 
9809 
09012 
QOG 1 1 
O81 2 
00013 
Q6014 
00815 
Q8B16 
G0817 
00018 


00019 : 


008208 
G802 | 
QO922 
98025 
00024 
90025 
888026 
00027 
00028 
Q0829 
00030 
08831 
00032 
00033 
00034 
98035 
08936 
Q0G37 
00038 
96039 
QO040H 
OO04 | 
QQB42 
G0043 
QB044 
00045 
00046 
G0047 
QGO48 
BQO49 
Q0050 
Q8@5 1 
00052 
QQ@853 
YOG54 
@0055 
00056 
Q0G57 
60058 
08859 
Q2060 
0086 1 


KS 
FO 
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; THIS PROGRAM IS A SAMPLE 
;USER FUNCTION TO BE USED 
; IN CONJUNCTION WITH KSCAN 
4 FR ET TH Re ee ee He HE Se HE He ee HE ae HE RE SHE Me ae 
BOX EQU 28866 

SCAN EQU @@2BH 

PWON EQU 4@@8H 

PWOF EQU 40@BH 

SRCH EQU 4@2CH 

LOAD EQU 4@41H 

FTYP EQU "TJ" 

NEW EQU  1B4DH 

RUN EQU 36E9H 

EXIT EQU  1A1SH 

WLTC EQU 68@0H 

RLTC EQU 30779 


BE ME WE Me De We RE He He He HE BE HE Re HE HE HE HE He RE aE He OE le He 3 He 


;USER: APPLICATION PROVIDED 
USER FUNCTION. 


USER PUSH AF 

ce Z 
NZ,USE4 
DAVE 
DBOX 
MEMES 
MSG 
SCAN 


N 

E- USES 
Cr noe 
JR NZ,USEZ2 

;LOAD THE DISK FILENAME 
CALL LNAM 

PONCCK. IF THE-PILE (EXISTS 
CALL FIND 

HL ,MESZ 

Zz 


NZ,USE1 
;CLEAR THE PROGRAM AREA 
CALL NEW 
CALL PWON 
CALL LOAD 
PUSH AF 
CALL PWOF 
POP AF 
iy MESS 
Q 


NZ,USEI 
DE, (30884) 
RUN 
USES CALL. RES] 

POP AF 

XOR A 

Red 


USEG4 POP AF 
RET 


«HERE HERE HE HE ME OE ME We HE KO ME KE Me He te ee Ke He Me te he te ee 


:DBOX: DRAW THE POPUP MENU. 


USE 1 
UIEZ 


QOO62 ; 


MILBURN ADS S 
ART—3 
060063 DBOX LD HL , BOX 
00064 LD (HL) , 142 
Q0065 INC HL 
00066 LD (HL) ,14@ 
0G067 LD DE , BOX+2 
00068 LD BC, 26 
GQ2G69 LDIR 
0Q07@ LD (HL) , 141 
0007 1 LD HL ,BOX+64 
00072 LD (HL) ,139 
08073 INC HL 
00074 LD (HL), 131 
00075 LD DE , BOX+66 
0876 LD BC, 26 
00077 LDIR 
00078 LO (HL) ,135 
06079 RET 
AAHBA 2 HE TE Ee AE HET HE HE HE ee RE He HE HEE HERR He a ae HE He 
00081 ;MSG: DISPLAY USER MESSAGE. 
OYG8? ; 
06083 MSG LD DE , BOX+37? 
00884 LD BC, 28 
08085 {DIR 
88086 RET 
00087 MES] EQU $§ 
Q0088 :3 
04089 DEFB 138 
Q0@098 *GO TO THE MAIN MENU (Y/N) ?* 
GQ091 DEFB 133°: 
Q0092 MES2 EQU $§ 
06093 :3 
G4094 DEFB 138 
@6@95 *ERROR: CHANGED DISK (Y/N) ?* 
08096 DEFB 133 
Q@@97 MESS EQU $ 
Q4098 :3 
QYVQ99 DEFB 138 
O@10@ * DISK ERROR: RETRY (Y/N)? #* 
03101 DEFB 133 
0107 TE RE AE HE ET Rt ME HE ee Hee RE Ee a Ree HE Re ae oe eae 
001@3 SAVE: SAVE THE SCREEN INFO 
00104 ; WHERE THE POP UP I5 
00105 : TO BE DISPLAYED. 
QG1@6 : 
@01@7 SAVE LD HL , BOX 
06108 LD DE , BOX] 
080189 LD BC ,96 
00110 LDIR 
00111 LD A,32 
08112 LD (WLTC),A 
00113 RET 
00114 BOX! DEFS 100 
001715 5 HE HE Be Te TE RE HE HEHE RT HE RE HE See HE Re ME et He ae 
@@116 ;REST: THIS RESTORES THE 
QO117 : DISPLAY BACK TO ITS 
00118 ;: ORIGINAL STATE. 
40119 :; 
00120 REST LD Hi ,BOX1 
00121 LD DE , BOX 
00122 LD BC , 96 
00123 LDIR 
00174 LD A, (RLTC) 


KSCAN PART—3 CONTINUED 


4AO/7 


00125 LO (WLTC) A 
00126 RET 

YO } tf + SR TR TE FE HE RE TE BE HE HEE He He HEE SE HE SE EO ee Hee aE ae 
00128 ;LNAM: LOAD THE NAME OF THE 
00129 ; PROGRAM INTO THE DISK 
00130 ; FILENAME BUFFER. 

OO131 ; 

08132 LNAM LO HL,FNAM 

00153 PUSH TY 

00134 POP OE 

00135 INC DE 

00136 LD —-BC,8 

00137 LOIR 

00138 LD = A,FTYP 

90139 LD (DE) ,A 

20140 RET 

00141 PNAM EQU 9 

00142 

20143 *MATNMENU* 

AA] 144 1 FFE FEF EE HE HE HE TE HE RE SHE SE FR BE HE HE Ok RE SHE ME SHE 3K 
@0145 ;FIND: CHECK THAT THE DISK 
OO146 ; CONTAINS THE PROGRAM 
BO147 ; TO LOAD. 

00148 

@0149 FIND CALL PWON 

00150 CALL SRCH 

00151 PUSH AF 

00152 CALL PWOF 

00153 POP AF 

00154 RET 


EDITOR'S COMMENTS : 


THE SOURCE CODE FOR KSCANZ.1 CONSISTS OF 5 FILES. INIT@, BASIC, 
SYSTEM, -PROY -@nB- MATRIX. DELOW YOU WILL FINO DETAILS OF EACH FILE 
TOGETHER WITH NUMBER OF LINES OF EACH FILE AND NUMBER OF PAGES PER 


FILE WHEN PRINTED IN TWO COLUMNS PER PAGE (SEE PAGE 6 FOR EXAMPLE). 


PRINTED 5/4 PAGES PER ISSUE IT WOULD TAKE 4/5 ISSUES TQ 
IS TOTALLY UN-ACCEPTABLE. 


IF [I 
COMPLETE WHICH 


ONLY ONE EDITOR ASSEMBLER IS CAPABLE OF ASSEMBLING THE SQURCE 
CODE, LESLIE MILBURN'S DISKOPS6 (64K VERSION - PuBLIC DOMAIN) MUST BE 
USED, BESIDES NEEDING THE EXTRA MEMORY DISKOPS65 ALSO HAS ADDITIONAL 
COMMANDS, ONE OF WHICH IS USED TO ‘LINK’ THE SOURCE CODE TOGETHER. 
INIT@ 15 @5 A815 DEEF 36DC - LINK BASIC - 694 LINES — 5.6@ Paces 
BASIC TA 865 AS135 C831 ZO1E - LINK System - 451 LInes - 3.63 Paces 
SYSTEM 0B @C A813 BZE7 @FD4 - LINK PLOT - 18@ LINES - 1.45 PAGES 
PLOT QD @D A813 AABA 8277 - LINK MATRIX ~ ?1 LINES - @.16 Paces 
MATRIX VE O85 A815 DW4D 283A - - 599 LINES —- 4.33 Paces 

1945 LINES - 15.58 Paces 
USER WZ 48 A815 B354B @B38 - PRINTED THIS ISSUE. 
KSCAN2.1 @! @@ 7AE9 8267 O77E ~ KSCAN2.1 OBJECT CODE «M/c) 
FOR ANY INFORMATION ON KSCAN2.1, ITS SOURCE CODE or DISKOPSE6 


CONTACT LESLIE MILBURN, ADDRESS AND PHONE NUMBER ON PAGE 12 


OPERATING INSTRUCTIONS FOR 40/8 
EXTENDED DOS FACILITIES 
SY LEStse 


EXT DOS V12.1 COMMANDS 


FORMAT 


THIS IS THE SAME aS DOS INIT. [Tt INITIALISES A DISK FOR USE. WHEN 
FINISHED IT PROMPTS USER FOR A DISK LABEL AND THE CURRENT DATE. 


LABEL - THIS ALLOWS THE USER TO PUT A LABEL ON A FORMATTED DISK. 
VOL - THIS ALLOWS THE USER To READ BACK THE DISK LABEL. 


NOTE : THE O©ISkK LABEL USES A S:FILETYPE (System FILE) AND OCCUPIES 
ONE SECTOR ON THE FLOPPY OISKETTE. IF YOU WISH TO PLACE THE DISk 
LABEL ON PART OF THE DISK WHICH IS NOT USED THEN I SUGGEST THAT THE 
SECOND HALF OF TRACK @ SECTOR 15 BE USED. THIS IS CURRENTLY UNUSED. 


DIS? — €P) = FILETYPE COPTIONAL) 


THIS DISPLAYS ALL FILES ON THE FLOPPY DISKETTE BY Y:FILETYPE. THE (?) 
TS OPTIONAL BUT IF NOT SPECIFIED THEN ALL FILES WILL BE DISPLAYED. IF 
T IS SPECIFIED, (IE. DIST) THEN ONLY T:FILETYPES wILt BE DISPLAYED. 
THE OUTPUT FORMAT IS AS FOLLOWS: 


FILETYPE:FILENAME - START - MEMORY ADDRESS 
TRACK SECTOR - START ENO 
Ts FILENAME 01 @@ 7AES 8673 


AFTER EACH SECTOR OF THE DISK DIRECTORY HAS BEEN DISPLAYED THE OUTPUT 
WILL BE PAUSED. PRESS SPACE TO CONTINUE LISTING OR BREAK Td ExtIt. 


CHA"FILENAME",? — ©?) = FILETYPE 


THIS FACILITY ALLOWS YOU TO CHANGE THE FILETYPE OF A FIL= ON DISK. 
THE FILENAME ANO FILETYPE arRE REQUIRED. 


NOTE : AFTER CHANGING THE FILETYPE THE PROGRAM OR DATA MAY NO 
LONGER RUN oR LOAD. CHA CAN BE USED TO PROTECT FILES AGAINST 
ACCIDENTAL ERASURE OR TO CONVERT SOURCE CODE FILES FOR USE WITH OTHER 
EDITOR ASSEMBLERS. 


REL" FILENAME" ,«<x*xx 


THIS FACILITY ALLOWS YOU TO RELOCATE A FILE. THE FILENAME AND NEW 
START ADDRESS IS REQUIRED. © A NEW END ADDRESS IS AUTOMATICALLY 
CALCULATED AND BOTH THE NEW START AND END ADDRESSES ARE PLACED INTC 
THE DISK DIRECTORY. USE HEX NUMBERS ONLY. 


NOTE : A BASIC PROGRAM CAN BE RELOCATED TO A NEW START ADDRESS. 
HOWEVER, SOMETIMES THE RUN COMMAND WILL NOT WORK. HINT: TRY TYPING 
THE FIRST LINE IN IMMEDIATE MODE THEN GOTO 2@ (FOR EXAMPLE) . 


EMAL KKK-K LY YYY 


THIS FACILITY ALLOWS YOU TO EXAMINE ANY TRACK (XxxXX) AND SECTOR (Y/YYY) 
ON THE FLOPPY DISKETTE. USE ONLY HEX NUMBERS. THE SECTOR WILL THEN 
BE DISPLAYED. PRESS SPACE TO CONTINUE SEEING THE FOLLOWING SECTORS ON 
THE DISKETTE. TO ExIT use BREAK. 


YOGI 
YOOO? 
YOURS 
YOUUO4 
WOODS 
BVOGE 
QQOB7 
YOUBS 
YOOOY 
YOU1Y 
YOO I | 
8001 z 
YOO15 
YoOY14 
G@815 
YOW165 
OGQ1/ 
QQ018 
YOB19 
BY828 
BOO? | 
BOO22 
YOO? 5 
YO824 
QOW25 
QOB26 
QOO27 
QBOBZ2S 
QOB2Y 
YOOSV 
YO8S | 
YOBS2 
40055 
QOUS4 
Q0W55 


ExT DOS COMM'S vi12. 
fT A TERE NOR Me ey eee ee ace Pee ele 
‘EXTENDED DOS COMMANDS V12.1 
“CODE IS NOT RELOCATABLE. 


«HE Ye RE RE KE HE RE HE KE SE HE HE HE Hie HE SHE HE HE HE Te HE Se HE HE HE OE Xe 


PCHR 
STeR 
GCHR 
PMSG 
PWON 
PWOF 
DERR 
SRCH 
SECs 
Cal 
WRTE 
INBF 
INPT 
FSAV 
COMA 
HE X 
iS 
WKEY 
BAS 
NEW 
RST 
ORG 
SBAS 
LOM 
HT AB 
Sorc 


, 
» HE KE He KE FE HE HE HE He HE SHE RE TE HE HE HE HE HE ME HE HE HE RE HE HK HE HE 
’ 


*BRUN: 


DOO36 


QQ03/ 
00038 
QB0339 
BQH40 
YOO4 | 
QOB42 
Q0G0435 
00044 
QOB45 
QOYB46 
QQG4/ 
QUG48 
YQO49 
BOO5u 
QYO5 | 
BOO52 
40055 
YOO54 
Q0O55 
BOB5b5 
BOG57 
YOU5 
YVOO5Y 
QOUEO 
BYC61 
YOVb2 


BRUN 


He HE te RE Th HE RE HE KE He HE SE He HE HE HE TE Se HE HE HE HE HE OE EE HE 
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TLS: FUNCTION Cheeks 
AND PROCESSES THE NEW 


a LY 


CMD 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EF QU 
EQU 
EQU 
EGU 
EQuU 
EQU 
EQU 
EQU 
E QU 
EQU 
EQU 
E QU 
EQU 
E QU 
EQU 
FQU 
EQU 
FE QU 
EQU 


THIS: FUNG TION: IS 
CALLED WHEN RUN FROM 
DISK. 

CALL CLS 

LD SP ,/7/0@H 

LD HL, (RST) 

LD (VC TR) sale 

LD HL, CMD 

ED CRS 41) gh 

DEC HL 

LD ClOPD fA 

LD DE ,5@ 

OR A 

SoG. Jab. De 

LD (SSF CG) fA 

LD HL ,ORG 

Ee (SBAS) ,HL 

CALL NEW 

JP BAS 


Y53AH 
1997H 
1D/8H 
2O75R 
GBO8H 
400BH 
4BWEH 
4Q02CH 
4055H 
401DH 
4032H 
79SE8H 
0567H 
4O44H 
44 
4020H 
YIC9H 
49H 
1A19H 
1B4DH 
7804H 
7 AESH 
7 8A4H 
78B1H 
78A0H 
7 8A8H 


COMMANDS . 


EXX 
Li) 
POF 
OR 
SpG 


HL, |}O05BH 
DE 

A 

ri We 


PUSH OG 


1 CONT. 4Q/9 
00063 EXX 
QOO64 JP NZ, GCHR 
00065 PUR “Ae 
YO055 CALL. GUAR 
QO867 JR NZ,CMD1 
Q@@68 POP POP HL 
YO869 LD DE, tv) 
00079 POSE: UE 
QO7 1 RET 
Q@@@72 CMD1 CP "ye 
00075 JR NZ,CMODZ 
0O074 — CALL VOL 
QQ075 JR Cyr OR 
Q00/6 JR CMDX 
Q@@Q77 CMD2 CP "LS 
YOO JR NZ,CMDS 
Q0079 CALL, RABEL 
QBA8H JR Coe er 
00081 JR CMD X 
Q@@82 CMDS CP “Ee 
Y8085 JR NZ,CMD4 
08084 CALL EXA 
Q0085 JR: CFO 
QVO85 JR CMD X 
0@087 CMD4 CP pe 
00088 JR NZ,CMD5 
00889 CALL DIS 
QQ090 JR Cer Or 
QOG9 1 JR CMD xX 
@@@692 CMD5 CP " 
00@95 JR NZ, CMD65 
Q0094 CALL CHA 
WQ@@95 JR C, POP 
QOU96 JR CMD 
QOOS7 CMDB CP ae 
00098 JR NZ,POP 
QBO99 plies “Re 
0010 JR Car OP 
@@1@1 CMDX POP ODE 
00102 POP DE 
YO105 LD De, FOTE 
00104 PUSH DE 
YO105 RE | 
QOW1iYo VCTR DEFW @ 
08107 FNAM EQU $ 
08168 :1 
Q0@1@9 *DISKINFO* 
Yi11i@ SI SE AEE OR eae Me BAe ae eas ee ae a Ae ie eee ae 
YOIT* sV¥Gke THIS DISPLA’S. THE Dlr 
OWiizZ ;: LABEL. 
OWO113 ; 
YO8114 VOL CALL GCHR 
YO1I15 ice ae 
BOl16 SGF 
00117 RET NZ 
OBIi8 CALL GCHR 
OWB1I1Y ae “a 
W012 SGP 
WO1 21 RE! NZ 
OOWiZz CALL GCHR 
AW 25 JP NZ ov ee 
Q@124 ;SAVE THE BUFFER POINTER 


EXT DOS COMM' sS V1 


QWiol 
Q0162 
YO165 
00164 
YW165 
00166 
YO16/7 
YO158 
Q@169 
001 /¥Y 
QO) 71 
Y0172 
00175 
00174 
YO175 
0O176 
O01 77 
a 178 


ees 
‘Ooes 


00 00 OG WY 
PI | 


PUSH HL 
*-LOAD THE FILENAME 

CALL LNAM 

DI 

CALL PWON 

CALL SRCH 

CP Z 

8 A,13 

JP NZ,DERR 
-UPON EXIT FROM SEARCH DE 
‘POINTS TO START TRACK IN 
“DIR ENTRY; 

LD A, (DE) 

LD (TY+18),A 

INC DE 

LD A, (DE) | 

LD (TY+17),A 

eis, ye 

CALL PWOF 

Et 
-CLEAR TWO SCREEN LINES. 

LD HL, (782@H) 

PUSH HL 

LD B,54 

LD A,32 
VOL? CALL PCHR 

DJNZ VOL} 

POP HL 

LD (7820H) , 

i) A,@ 

LD (HTAB) A 
‘GET POINTER TO DISK LABEL 

LD H, (LY+5@) 

LD L, (LY+49) 
»SAVE IT 

PUSH HL 
‘PLACE A NULL BYTE AFTER 
»-EACH STRING. THIS MEANS 
“THAT 
»>QUICKWRITE CAN BE DISPLAYED 

PUSH: AL 

LD DE; 62 

ADD HL,DE 

LD (HL) ,@ 

ADU: ‘Hb.BE 

INC HL 

INC HL 

ADD HL,DE 

LD (HL) ,@ 
-DISPLAY DISK LABEL. 

POP HL 

CALL PMSG 

LD A,13 

CALL PCHR 

POP HL 

LD DEY bo 

ADD HL,DE 

CALL PMSG 

LL A.43 

CALL PCHR 

POP HL 

OR A 


HL 


DISK LABELS CREATED BY 


ae A 


00187 
08188 
08189 
00190 
881391 

Q8192 
YO1935 
00194 


@@195 


00196 
Q0197 
08198 
00199 
QU20U 
8020) 
QO202 
80205 
00204 
00205 
QQ206 
QO207 
00208 
88209 
00210 
GO211 
QB212 
QO215 
QO214 
Q0215 
BAZ16 
QB217 
00218 
WO219 
QB220 
06221 
QB222 
00225 
YO224 
QO225 
Q8226 
YO22Z/ 
QO228 
QO229 
00230 
06231 
90232 
00235 
00234 
Q0235 
00256 
QO257 
00238 
QB259 
OB240 
YO24 | 
BOZ42 
BO245 
YY244 
BY2Z45 
VB2Z465 
YO24/ 
YWO248 


CONT . 


RET 
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OEE BORA Ae Ee eee te Sec ee ee 


:LNAM: THIS FUNCTION LOADS 


; THE FILENAME 


ENO. Ce 


DISK NAME BUFFER. 


LNAM LD 
PUSH 
POP 
INC 
LD 
LDIR 
LD 
AEST 


HL,FNAM 
LY 

DE 

DE 

BGG 


CLF o): 


a FE RE RE HE RE ME HE HE KE A HE SE KE HE HE HE HE HE EOE A HE HE HE OE RE 
? 


>LABL= THIS. FUNCTION PLACES 
A LABEL ON A DISK 


LABL CALL 
CP 
ocr 
RE 
CALL 
CP 
aU 
RET 
CALL 
os 
SOF 
RET 
CALL 
CP 
SCE 
RET 
CALL 
JP 


GCHR 
"AS 


NZ 
GCHR 
"hy 


NZ 
GCHR 
ne" 


NZ 
GCHR 
7a 


NZ 
GCHR 
NZ,S5YER 


SSAVeE BUPPER POINTER: 


PUSH 


HL 


PSAVE INPUT BUFFER CONTENTS; 


LAB! 


HL, INBF 
DES OrzZ 
BC, 64 


Lalas 
PMSG 
INPT 
C,LABX 
A, CINBF) 
52 
Z,LAB1 


sCOPY INPUT TO INTERNAL 


; BUFFER; 


JR 


“COPY INPUT TQ 


DE. CBF | 
HL, INBF 
BC 02 


FLAME SZ 

PMSG 

INPT 

C, LABX 
(INBF ) 


mJ 


7, LAB 
INTERNAL 


EXT DOS COMM' S V12.1 CONT. 


BAZ4S 
YO258 
OH25 | 
QO252 
BO255 
BY254 
940255 
QO256 
YO257 
90258 
YO259 
YO258 
YO251 
YOZ62 
YO265 
YO264 
00265 
YWO256 
YO25/7 
00268 
QO259 
YO2/0 
YWO2/ | 
{O27 2 
YO275 
YOZ/4 
QO275 
QO2/6 
Q02// 
YWO2/8 
YO279 
B289 
WO23 | 


my gy 


BO2ZS6 
DW28/ 
YO23¢ 
YE2Z89 
O829U 
VY2Z9 1 


eee _ 


YWB29/ 
YB29& 
YO299 


a 17) 


WW Swe 
YYSW5 
YYIYH 
YY / 
WYS08 
DESOY 
W435 14 


a 
4 


a 
, 


1 
4 


‘CHECK IF 


SURPER. 
LD DE gis rR S 
Lal HL, INBF 
LD BL, 02 
LR 


PLACE LABEL NAME INTO 
DESK -BUPRER: 
CALL LNAM 
DI 
CALL PWON 
THE FILE ALREADY 


gE RLS) Ss 


CALL SRCH 
Le Z 
JP ZS DERE 


; SAVE THE CURRENT START AND 
PEND OF BASIL: POINTERS. 


Se) 
;ADDRESS 


LO HL, (/8A4H) 
PUSH AL 

LD HL, (/8F YH) 
PUSH HL 

THE START AND END 
OF LABEL DATA. 


LE Aegis 
LD (7 SA4H) .HL 
LD At Brie l26 
LD (73FQGH) , AL 
CALL FSAV 
CALL PWOF 
ep 
FRESTORE ORIGINAL START AND 
»ENEY OF BASIC POINTERS. 
FOP HL 
i (7 SPSHI AL 
POR «ab 
LD (78A4H) , HL 
bee 1 Ai ge bre 
-RESTORE INPUT BUFFER COQONTS. 
| DE, INBF 
LU BC ,o4 
LDIR 
POP HL 
OR A 
RET 
MES cage 4 
Sa 
"EM CER PESK, “LABEL S=* 
DEPB: ‘kS 
DEFB @ 
Mes2 el 
ENTER FODAY Ss UAE 
Deri es 
DEFER Y 
INTERNAL BUFFER FOR STORING 
TRE TSK LABEL. 
vee ees hae 
Wire agers ioe 


«REE Oe He Ke EE He HE Eh HK RE OE HE HE HE KE HE HE HE KE He ME HE RE HE 
, 


Peg A: TAis FUNCTION ALLOWS 
ANY SECTOR TO BE 

ylewEU. 

FAS CALL iotHR 


BY 


CA Od Ou Gu Gt 


Os, ££ uipy — 


CN 


So ceo & 
GS Qo eas 


QW317 
YBSI8 
YUS519 
WWS20 
YQO32 1 
YOS22 
00525 
00524 
QW325 
00526 
Q032/ 
00328 
QB429 
00530 
00355) 
OU352 
040555 
QO534 
40335 
90336 
6335/7 
004538 
QH33Y9 
YY54U 
JO341 
AY34? 
NO545 
YO3S44 
YBOA345 
QYS546 
YOS34/ 
YWO34S 
BO@S49 
YA55Y 
4055] 
QY552 
00355 
004554 
YYS555 
00356 
0035/7 
AO558 
YAA5Y 
YOH359 
QO561 
ADSbB2 
YO565 
00464 
YBAB5 
AB366 
YOS67 
WY368 
AYS649 
BYS7A 
WYs7 
YWOS7 = 
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ce a 

SCF 

KET NZ 

CALL GCHR 

ce oA 

SF 

RET NZ 

CALL GCHR 

Ce COMA 

Sor 

KET NZ 
s; INCREMENT POINTER PAST THE 
*COMMA . 

INC HL 

CALL HEX 

RET 3 

PUSH HL 

LD HL, 39 

eST  |&H 

FOP HL 

RET €C 

LD (LY¥+18),€£ 
ZH AECK NEXT CHAR. 

LD A, CHL) 

ce COMA 

SGP 

KET NZ 

INC HL 

CALL HEX 

Mey te 

Pigs. vac 

ie HL, 16 

KST 18H 

FOP HL 

PEL 6 

LD CYT fo Se 

Det Al 

CALL GCHR 

JP NZs OER 
FSAVE BUFFER POINTER 

PUSHUHE 

CALL CLS 
EXA! OF 

MALL PWON 

CA Geo r 

CALL PWOF 

ef 
rOULSPLAY THE SECTOR. 

CALL DSCT 

{OD A, (1Y+17) 

INC A 

CP 16 

JR Z,EXAG 
FXAZ LD CL SIT ok 
EXAS CALL WKE¥ 

LR Z,EXAX 

= eZ 

aK Li 

UR EARS 
EXAG 24 Ay Ub eB 

ENC A 


CONTINUED NEXT LSeSeaUe « « 


DISKOPS1 & 2 CDISK OPERATIONS) 40/712 
INSTRUCTIONS BY LESLIE MILBURN 


THIS IS A MACHINE CODE UTILITY WHICH ALLOWS MACHINE CODE 
PROGRAMMERS USING THE ODICK SMITH EDITOR ASSEMBLER TO SAVE AND LOAD 
THEIR SOURCE CODE TO AND FROM OISK. (NOTE TO SAVE OBJECT CODE a TAPE 
MUST STILL BE USED) AS THE PROGRAM IS NOT RELOCATABLE TWO VERSIONS ARE 
SUPPLIED ON DISK, THESE ARE:- 


DISKOPS1 - EXPANDED VZ20@ 
DISKOPS2 - EXPANDED V2Z300 


GETTING THE PROGRAMS OPERATIONAL :- 


STEP 1: POKE 30897,2@@:POKE 30898, 242 
STEP 2: BRUN"EDITOR ASSEMBLER" 
OR: CRUN“EDITOR ASSEMBLER" 
STEP 3: ONCE THE EDITOR ASSEMBLER IS OPERATIONAL ENTER THE FOLLOWING 
LINE:- 
JP 4005H - ASSEMBLE AND RUN. THIS WILL REBOOT THE DOS. 
STEP 4: BRUN"DISKOPS 1 OR 2” DEPENDING ON THE MEMORY SIZE OF YOUR VZ. 


THE ADDITIONAL COMMANDS ARE: — 

TU:FILENAME - LOAD SOURCE FILE FROM OISK. 

TR:FILENAME - SAVE SOURCE FILE ON BTSK. 

TD: - THIS IS FOR USE WHEN THE SOURCE FILE ISN'T COMPLETE. 
THE SOURCE CODE IS SAVED WITH THE FILENAME OF SOURCE. 
IF THE FILE ALREADY EXISTS THEN THE NEW FILE 
REPLACES THE FILE ON DISK. 


WARN ING : — 
THE TD: ROUTINE INTERFERES WITH THE DISK TRACK MAP SC USE THIS 


WITH CAUTION, [IT RECOMMEND THAT A_ SEPARATE DISK SBE USED AS IT IS 
POSSIBLE FOR DISK FILES TO BE DAMAGED. 


NOTE: — 
ALL SOURCE CODE FILES WHEN SAVED ARE OF FILETYPE ‘W' AND ONLY THE 
FIRST 8 CHARACTERS OF THE FILENAME ARE RECOGNISED, IE: W:FILENAME 


ERROR MESSAGES: — 


IF THE ORIGIN IS NOT SET TO THE FIRST FREE BYTE AFTER THE SOURCE 
CODE USING THE ‘O' <<RETURN>> COMMAND THEN YOU WILL GET A *** WRONG 
ORIGIN FOR RUN ***® ERROR. 

INF ORMAT LON AND SOURCE CODE: — 


WRITE TO LESLIE MILBURN:- FOR A SOURCE CODE LISTING OR IF YOU HAVE ANY 
OTHER PROBLEMS. 


LESLIE MILBURN 11 SWORDFISH AVENUE RABY 2506 PHONE (02) 6@05-598° 


A SOURCE CODE LISTING IS AVAILABLE FOR 35-Q@. 


ASSEMBLY Ae ae rg 
t 


PART IIL 


Y BOB KITCH 


LISTING 5: 


0010 
9620 
0030 
0040 
8050 
QO088 
Q089 
G090 
01008 
O11@ 
01208 
0138 
0140 
015@ 
0160 
0178 
0180 
0190 


1 Mt SRE HE HE WUE HE HE EME HE HE HE HE HE HE HE HE Me HE ME Oe HE He EE 


eee 1550 NZ. “SCREENS -*** 
ean VERSION 1.3 ee 
OE, “RoBaks  VOLOLEo oF F* 


1 FRE We Fhe BRE SHG iE SRE AH RE RE HE HE He HE RE RE HE HE He HE aE te 


BYTES BY LOWERING [OM. 
:'7847H AS LOAD CHECK. 
:' TOM POINTERS. 

:' PROTECT 2@ BYTES. 

: “NEW TOM POINTERS. 


'**®*ETND TOP OF MEMORY AND PROTECT 20 
IF PEEK (30791)=77 THEN GOTO 5@@ 

M1=PEEK (30898) :L.1=PEEK (30897) 

TM=M1 *256+L 1-21 

MS=INT (17M/ 256) :LS=TM-MS*256 

POKE 30898,MS:POKE 30897,LS SET NEW TOM. 

CLEAR 50 > RESET ALL POINTERS. 
‘THIS ACTION DESTROYS THE VLT-ALL VARIABLES MUST BE RENEWED. 

M1=PEEK (30898) :L1=PEEK (30897 ) :'NEW TOM POINTERS. 
ST=M1*256+L1 +1 :'NEXT ADDR IN RESERVED 

MS=INT (ST/256) :LS=ST-256¥*MS :' START OF ROUTINE. 

IF ST>32767 THEN ST=ST-65556 :' CONVERT TO SIGNED INT 


8198 © 


0199 
O200 
8210 
9220 
0230 
O24 
025 
0260 
0278 


'***1 OAD MACHINE CODE INTO PROTECTED TOM AND SET USR POINTER 
CLS:PRINT@Z3@, "LOADING MACHINE CODE" 
CS2=@0 
FOR ID=ST TO ST+15 

READ VL%:POKE ID, VL%:CS%Z=CSZ+VL% 
NEXT ID 
IF CS%<>1483 THEN GOTO 1080 
POKE 30863,MS:POKE 30862,L5 
POKE 30791,77 


:' CHECK SUM COUNTER. 
:' LOAD 16 BYTES TO TOM. 
:'LOAD M/L INTO PROTECT 


;' WRONG DATA. 
:'SET USR POINTERS. 
:'SET LOAD CHECK. 


Q@399 ° 


G400 
0410 
0420 
9430 
B44 
0450 
9466 
0470 


'#**7~80 BLOCK MOVE ROUTINE. 


DATA @58,033,121 :'’tD A,(7921H) PICK UP VALUE FROM USR(). 
DATA 033,000,112 :'LD HL,7@@@H (#28672D START VIDEO RAM) 
DATA 017,001,112 :’LD DE,7@@1H (#28673D NEXT) 

DATA 0@1,255,007 :'LD BC,@7FFH (#2@47D SIZE OF VIDEO RAM 
DATA 119 :’LD CHL),A 

DATA 237,176 :'LDIR (BLOCK LOAD COMMAND) 

DATA 261 2 RET 


O498 | 


@499 
0500 
0518 
0520 


'*** INITIALIZE DELAYS - CONTROL SPEED OF EXECUTION BY D. 


TZ=@ :' TONE IS REST (@-31) 
DZ=4 : DELAY IS SHORT (1-9) 
P%=30/44 :' SET UP SCREEN MODE. 


Q594 ' 


Q@595 
A596 
9597 
9598 
9599 
G600 
0619 
9620 
9630 
4640 
0658 
Yo6@ 
0679 
0680 
A690 
Q699 


'***THTS LOOP DOES A LOT OF WORK. 
'***TT LOADS ALL VALUES INTO THE A-REG FOR VIEWING. 
‘***TT SWAPS BETWEEN HI- AND LO-RES SCREEN MODES. 
'***TT SWITCHES BETWEEN NORMAL AND INVERSE SCREEN TYPES. 
'***TT SWITCHES BETWEEN GREEN AND ORANGE BACKGROUNDS . 
FOR AZ=@ 10 255 :'ALL VALUES PUT INTO A=REG. 
MODE (@) :POKE PZ,0 
CLS:PRINT@Z2354, "VALUE = 
X=USR (AZ) 
COLOR ,@:SOUND 1%,0% 
COLOR, |:SOUND 12%,0% 
POKE P%, 1 
X=USR CAR) 
COLOR,@:SOUND [%,D% 
COLOR, 1:SOUND 1%,D% 


"s:A%:SOUND 1%,0% 


40/135 


ASSEMBLY LANGUAGE CONTINUED 4/1 4 


@70@ ' HI-RES SCREENS. 

8710 MODE (1) 

0720 X=USR (AZ) 

0730 COLOR,@:SOUND 12%,0% 
8/49 COLOR, 1:SOUND 12%,DZ 
@75@ NEXT A% 

@800 GOTO 680 

0998 ! 

9999 '***WRONG DATA MESSAGE. 
19060 CLS:PRINT@23@, "ERROR IN DATA ";CS% 
1019 END 


FUNCTIONS IN BASIC 

TT MAY BE A SURPRISE TO MOST BASIC PROGRAMMERS BUT THE FUNCTION 
(FN) COMMAND, ALONG WITH THE SUBROUTINE (GOSUB) COMMAND, ARE PROBABLY 
THE MOST USEFUL BASIC COMMANDS. THEY ARE CONCISE AND CLARIFY BASIC 
CODING CONSIDERABLY. UNFORTUNATELY ONLY GOSUB IS SUPPORTED ON THE VZ. 


[ HAVE HAD A NUMBER OF QUERIES FROM USERS ON HOW TO USE THE FN 


STATEMENT ~- PARTICULARLY WHEN TRYING TO CONVERT PROGRAMS WRITTEN FOR 
OTHER MACHINES. IN THIS BRIEF NOTE, I WILL TRY TO EXPLAIN HOW TO SET 
AROUND IT. 


IN THE Levet I] BASIC THAT IS IN THE VZ'S ROM, Two TYPES OF 
FUNCTION ARE SUPPORTED - 


1. LIBRARY (OR SYSTEM) FUNCTIONS, AND 
2. USER-DEFINED FUNCTIONS. 


FUNCTIONS CAN BE USED TO MANIPULATE NUMERIC OR STRING DATA TYPES. 
THE VZ SUPPORTS A NUMBER OF INTRINSIC OR LIBRARY FUNCTIONS SUCH AS 
SOR, ATN, RND, CHRS, LEFTS and INT ETC. THE PROCEDURES FOR THESE ARE 
IMBEDDED IN THE ROM AS BASIC UTILITIES. STEVE OLNEY'S EXTENDED BASIC 
"WAKES UP" A FEW MORE, SUCH AS DEFINT, CSNG and STRINGS. 


UNFORTUNATELY ONE OF THE OMISSIONS FROM THE FULL LEVEL II 
IMPLEMENTATION ON THE VZ IS THAT THE USER DEFINED FUNCTIONS (DEF FNX) 
ARE NOT SUPPORTED IN ANY WAY. RUSSELL HARRISON'S EXTENDED BastIc XB 
DOES PROVIDE SUPPORT FOR DEF FN HOWEVER. NOTE THAT FUNCTIONS CAN ONLY 
RETURN A SINGLE VALUE TO THE CALLING PROGRAM. 


THE LACK OF THIS FEATURE OFTEN CROPS UP WHEN ATTEMPTING TO CONVERT 
PROGRAMS TO RUN ON THE VZ - BUT WRITTEN IN OTHER DIALECTS OF BASIC. 
THE CONCISE CODING INHERENT IN FUNCTION STATEMENTS IS ALSO A DESIRABLE 
FEATURE WHEN WRITING CLEAR CODE. FORTUNATELY A FAIRLY SIMPLE REMEDY 
IS AT HAND AND DESCRIBED BELOW. 


THE FUNCTION STATEMENT HAS TWO COMPONENTS. THE FIRST IS THE 
DEFINITION OF THE FUNCTION, AND THE SECOND, IS THE ACTUAL 
“~~ IMPLEMENTATION OR CALL TO THAT DEFINITION. LET'S EXPLAIN.... SUPPOSE 


THAT WE WISH TO FREQUENTLY COMPUTE THE AREA OF A CIRCLE GIVEN A NUMBER 
OF VALUES FOR THE RADIUS. THE COMMAND LINE 


1@ DEF FNACX) = 3.1416 * X * X 


SHOULD BE ODECLARED EARLY IN THE PROGRAM. DEF MEANS DEFINE, FNA 
MEANS FUNCTION A (ANY LETTER FROM A TO Z CAN BE USED.), AND (X) IS A 
DUMMY ARGUMENT FOR THE RADIUS USED BY THE FUNCTION. [HE RIGHT HAND 
SIDE OF THE ASSIGNMENT IS THE EASILY RECOGNIZED FORMULA FOR 
CALCULATING THE AREA OF A CIRCLE. 


ASSEMBLY LANGUAGE CONTINUED 40/715 


LATER IN THE PROGRAM, THE VARIOUS VALUES FOR THE RADIUS ARE 
ASSIGNED TO VARIABLE V (EITHER FROM DATA oR INPUT STATEMENTS.) AND 
THEN THE FOLLOWING LINE MAY APPEAR - 


21@ PRINT V,FNACV) 


THE TWO LINES GIVEN (18 AND 2180) WILL TOGETHER, PRINTOUT THE 
RADIUS AND THE CORRESPONDING AREA FOR A CIRCLE. THE CALL BY FNA SENDS 
THE INTERPETER OFF THROUGH THE BASIC PROGRAM TO FINO THE DEF FNA 


STATEMENT. WHEN LOCATED, THE VALUE V IS SUBSTITUTUED FOR THE OUMMY 
VARIABLE, THE CALCULATION CARRIED OUT, AND THE RESULT RETURNED TO THE 
CALLING SEQUENCE. (ONLY A SINGLE VALUE CAN BE RETURNED.) 


AS ALREADY STATED, THIS NEAT CONSTRUCT DOES NOT EXIST IN VZ BASIC. 
THE APPROPRIATE USE OF THE GOSUB/RETURN COMMANDS CAN OVERCOME THIS 
SHORTFALL. THE GOSUB COMMANDO CAN RETURN MANY VALUES ~ BUT A FEW MORE 
ASSIGNMENTS ARE REQUIRED BEFORE GOING TO THE SUBROUTINE AND YOU HAVE 
TO KEEP TRACK OF THE SUBROUTINES’ LINE NUMBER. 


AN EXAMPLE BEST ILLUSTRATES THIS —- AND LET'S USE THE PREVIOUS 
EXAMPLE TO SHOW HOW IT CAN BE IMPLEMENTED ON THE VZ..... 


1@ INPUT "ENTER RADIUS OF CIRCLE ";R 

2@ GOSUB 1600 

3@ PRINT“RADIUS ";R,"AREA ";A, “CIRCUMFERENCE °;C 
4@ GOTO 16 

1@@@ A=3.1416*R*R 

101@ C=2*3.1416*R 

102@ RETURN 

2000 END 


NOT TOO DIFFICULT TO SET UP IS IT? NOTICE THAT TWO VALUES (A AND 
C) WERE RETURNED. THE CODING AND PROGRAM FLOW IS NOT QUITE AS CLEAR 
AS USING THE FUNCTION STATEMENT. 


HAVE FUN! AND DON'T BE FOXED BY FUNCTIONS WHEN NEXT CONVERTING 
PROGRAMS ONTO THE VZ. 


TECHNICAL-DATA SHEET # 1 


WORDPRO & DD POWER SUPPLY CIRCUITS: 


BOTH CIRCUITS WERE SUPPLIED BY DAVE BOYCE SOME YEARS BACK AND ARE 
PUBLISHED AS A SUPPLEMENT TO THE TECHNICAL REFERENCE MANUAL. 


WORDPRO CIRCUWLTT =: —- CAN SOMEONE HELP WITH A TRUTH TABLE 
FOR THE DECODING CIRCUIT PLEASE AS IT HAS SOME UNUSUAL DECODING, ED. 


DD POWER SUPPLY CIRCUTIT: 


THIS IS A STANDARD POWER SUPPLY CIRCUIT WITH NOTHING FANCY. True 
WILL BE INVALUABLE FOR THOSE WITH A CROOK POWER SUPPLY UNIT OR FOR 
THOSE WHO NEED ONE AND WOULD LIKE TO BUILD ONE THEMSELVES NOW THAT 
THEY ARE NO LONGER AVAILABLE FROM DICK SMITH. 


NOTE : IF THE DEMAND IS THERE I[ COULD PREPARE A PROJECT FOR 
PUBLICATION, 8UT PLEASE LET ME KNOW AS SOON AS POSSIBLE, ED. 


40/16 


WORD PROC. 


DISK DRIVE POWER SUPPLY CIRCULT 


TECHNICAL DATA SHEET # 1 








VPINGARS ANT‘'O = po-To 


GQ Ben io OOS 1b2 


3105 ONY = Ta + 24 + Tq 
4LivS yO = Gzn + gzn + v2n 
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DRIVE HEAD PARK UPDATE 40O—17 


AS A TWO ORIVE USER I FOUND IF I USED PARK IN ORIVE 2 IT wouLD 
PARK DRIVE 2. ON POWER UP OR RESET DRIVE 1 WOULD BANG ITS HEAD OFF, 
JASON OAKLEY MODIFIED IT SO PARK WOULD ALWAYS PARK DRIVE 1} REGAROLESS 
OF WHICH DRIVE IT WAS RUN FROM. 


LOAD PARK SOURCE CODE INTO YOUR EDITOR ASSEMBLER AND INSERT THE 
FOLLOWING LINES BY TYPING [19 AT THE COMMAND PROMPT. 


920 ;SELECT DRIVE 1 
021 LD A,1@H 
O22 LD (IY+@BH) ,A 


AS you INSERT THE CLINES @28-@22 THE OLD LINES FROM @70-070 ARE 
BEING RENUMBERED TO 923-@73 TO END OF PROGRAM. Next EDIT LINES @63 
AND @72 AS SHOWN BELOW. 


663 * PARK? BY DAVE MITCHELL 
Q72 * DRIVE?! HEAD IS PARKED* 


THAT FINISHES THE MODIFICATIONS. SAVE THE SOURCE ANDO O8VECT CODES 
AS SHOWN BELOW OR ACCORDING TO THE SYNTAX OF YOUR EDITOR ASSEMBLER. 


07200H - SET ORIGIN 

A ~- ASSEMBLE 
TS:PARK-1 - SAVE sSouRCE CODE 
TO:PARK?t - SAVE OBJECT CODE 


REGARDLESS OF WHICH DRIVE You BRUN"PARK1i" FROM, DRIVE 1 WILL 
ALWAYS BE THE DRIVE WHICH IS PARKED, WHICH MEANS NO MORE 
UN~-INTENTIONAL HEAD BANGING. Happy PARKING !'!! 


GARY BULLEY VZMOUSE ERRATTA: 


SOME ERRORS CREPT IN WHEN I WAS PREPARING GARY'S VZMOUSE PROVECT 
IN LAST ISSUE. MY¥ APOLOGIES TO GARY BULLEY AND ALL CONCERNED, ED. 


THE ERRORS WERE IN THE VERO BOARD LAYOUT AND CONNECTIONS. THE 
CORRECTED (I HOPE) VERSION IS SHOWN BELOW. DO NOT FORGET TO CUT OFF 
PINS 6 & 8 ON U2 AND PINS 4 & 10 ON U3 WHICH ARE NOT USED AS IT 
SIMPLIFIES BOARD LAYOUT. THE ‘B' CONNECTION FROM PIN 5 ON U2 IS MADE 
DIRECTLY TO PIN 3 ON U1. OTHER CONNECTIONS ARE AS SHOWN. 


OUSE SIF L= p19 
NOTE: QUT OFF PINS .&.3.8..9ON U2 8 PINS 4.2% 10 ON UZ 





40/18 


TECHNICAL DATA SHEET # 2 
STATIC RAMS & VZ ROMS 
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JINGOW WEUS AZTS 


DIAGRAMS ARE PRESENTED OF STATIC RAMS FROM 2K TO 


128K, 512K MODULE, VZ200/3@@ 8K & 16K BASIC ROMS ano 8K DOS ROM. 
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PINOUTS AND BLOCK 
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we te DAVE MITCHELL SOFTWARE * 4/19 


E & F bf PATCH 3.3: PatcH 3.3 WRITTEN BY DAVE MITCHELL WILL 
CONVERT your E & F TAPE WORD PROCESSOR For FutL DISK USE WHILE RETAINING ALL 
ORIGINAL FUNCTIONS. IT ALSO HAS SHIFT LOCK AND PRINTER CONTROL CODES WHICH CAN 
BE IMBEDDED IN TEXT AND SAVED TO TAPE OR DISK. 


BSTWE .F: THIS UTILITY PROVIDED WITH PATCH 3.3 WILL CONVERT BASIC 
PROGRAMS AND EO/ASS. SOURCE CODE FILES INTO WORD PROCESSOR FILES. 


PRICE : AUS/NZ AUS20.00 - UPDATE — AUS-$10.00 - NZ-AUS11 G0. 


EXTENDED DOS V1.3: THESE COMMANDS ARE AT YOUR DISPOSAL: MERGE, 
OIRA, OIRA, OIRB, LDIRB, OLD, OLD., DEC, HEX, MENU, CODE, LIAB, MOVE AND UPDATE, 
STATUSA AND LSTATUSA. STATUSA AND LSTATUSA ALSO WORKS WITH VERSION 1.@ DOS 


PRICE : AUS15.@0 - POSTAGE INCLUDED 


MENU/FILE COPIER: THIS UTILITY WILL READ YOUR DISK DIRECTORY AND 
PRESENT YOU WITH SEVERAL OPTIONS. USING THE CURSOR YOU CAN RUN/BRUN ANY PROGRAM 
OR SELECT FILE COPY, REN, ERASE, DRIVE 1 OR 2, ETc. Besrpes COPYING TEXT AND 
BINARY FILES ALL OTHER FILES CAN BE COPIED AS WELL EXEPT FOR DATA FILES. 


PRICE : AUS15.00 — POSTAGE INCLUDED 
FOR PURCHASE OR INFORMATION CONTACT : 


DAVE MITCHELL 24 ELPHINSTONE STREET 
NORTH ROCKHAMPTON QUEENSLAND 4701 
AUSTRALIA — PHONE: (079) 27 8519 


~ PETER HICKMAN SOFTWARE * * * 


VZ DISASSEMBLER : WHAT, ANOTHER DISASSEMBLER? 8UT, YOU HAVE 
ALREADY GOT ONE? THIS ONE IS DIFFERENT! THIS PROGRAM IS ENTIRELY WRITTEN IN 
MACHINE CODE. IT ACTUALLY RUNS ABOUT 4@ TImes FASTER THAN D.S.E.'S DISASSEMBLER 
(oR ANY ONE ELSE’S ). IT WILL DISASSEMBLE ANY PROGRAM THAT YOU CAN BLOAD INTO 
MEMORY. 1T WORKS WITH ANY VZ CONFIGURATION. IT DISASSEMBLES EVEN THE 88 EXTRA 
780 OCPCODES THAT ZILOG DOESN'T ADMIT TO. 


PRICE =: AUS25.@0 - PRICE INCLUDES HARDCOPY MANUAL. 
TAPE AND OISK VERIONS AVAILABLE. 


VZ MODEM SOFWARE : DID YOU WANT TO TALK TO OTHER COMPUTERS VIA A 
mopem? DID You BuY THE DSE TERMINAL EPROM, ONLY TO DISCOVER THAT IT ONLY WORKS 
WITH TAPE. IT ONLY ALLOWS YOU TO PRINT FILES, NOT SAVE THEM OR SEND THEM! 


YOUR PROBLEMS ARE SOLVED! THE HICKMAN BROTHERS, PETER AND ANDREW, HAVE A 
BRAND NEW PROJECT WHICH WILL ALLOW YOU TO SEND, RECEIVE & SAVE FILES VIA A 
MODEM. IT WORKS WITH DIX! 


SALE PRICE: %$25.@ —- INCLUDED ARE INSTRUCTIONS FOR THE HARDWARE 
MODIFICATIONS. A SMALL MODIFICATION IS NEEDED TO YOUR DISK CONTROLLER. YOUR 
USER GROUP MAY HELP YOU MODIFY YOUR COMPUTER TO USE THIS EXCITING NEW SOFTWARE! 


THE MANUAL IS SUPPLIED ON DISK FOR PRINTING OUT WITH YOUR DISK VERSION OF E 
& F W/PROCESSOR. IF YOU DO NOT OWN AN E & F W/PROCESSOR THEN PLEASE ENCLOSE 
ANOTHER $5.20 (TOTAL $30.@@) FOR PHOTOCOPYING AND POSTAGE OF THE MANUAL. 


FOR PURCHASE OR INFORMATION CONTACT : 
PETER HICKMAN PO BOX 8 WERRINGTON 2747 


VZ USER GROUPS & PUBLICATIONS 44) / 2H 


* #& CONTRIBUTIONS TO THE JOURNAL * ™ 
IF YOU ARE THINKING OF CONTRIBUTING TO THE JOURNAL THE PREFERED FORMAT Is 
BASIC LISTINGS, WORD PROCESSOR OR SOURCE CODE FILES ON TAPE OR DISK, FILES FROM 
THE FOLLOWING WORD PROCESSORS CAN BE ACCEPTED :~ 


E & F TAPE OR OISK PATCH 3.1-3.3, WORDPRO CARTRIDGE, WORDPRO PATCH, MOST SOURCE 
CODE FILES AND ALL QUICKWRITE WORD PROCESSOR FILES. 
“oe CLUB MEETINGS — ALL WELCOME ™ ™ 
FIRST FRIDAY OF MONTH 


~“m- FLITURE MEETINGS — NEW VENUE ™ ™ 


AS MENTIONED BEFORE WE NO LONGER MEET AT JUNC, BUT AT VARIOUS MEMBERS HOMES. 
MEETINGS WILL BE ONCE A MONTH AS BEFORE WITH THE DATES BEING FIRST FRIDAY OF THE 
MONTH. 


BECAUSE OF SOME LOCAL MEMBERS HAVING TO WORK SHIFTWORK MEETING DATES WILL BE 
ADUUSTED TO ACCOMODATE THEM. WHETHER YOU ARE A LOCAL MEMBER, INTRA OR 
INTERSTATE VISITOR PLEASE CHECK WITH JOE LEON FIRST BEFORE COMING OUT. 


JOE LEON 33 TIGHES Tce TIGHES HILL 2297 (@49) 692 599 


~ CLUB COMMITTEE & SUBSCRIPTIONS * 


PRESIDENT - ROSS WOODS - SECRETARY/EDITOR - JOE LEON 
COMMITTEE MEMBERS - COLIN BRIDGE - PETER JONES 


SUBSCRIPTION TO - AusT. - 3 ISSUES $11.00 - 6 ISSUES $21.00 
H.V.VZ. JOURNAL - N. Z. -— 3 ISSUES $13.00 - 6 ISSUES $26.00 


FOR MORE INFORMATION CONTACT: 
Joe LEON 33 TIGHES Tce TIGHES HILL 2297 (@49) 692 399 AUSTRALIA 
NOTE: PRICES INCLUDE POST & PACKING 


-“* YZ USER GROUPS & PUBLICATIONS ™* ™ 
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VZ DOW UNDER — VZ MAGAZINE - 6 ISSUES - $18.@@ PER ANUM 
HARRY HUGGINS 12 THOMAS SrReeT MITCHAM VICTORIA 3152 


WAVZ — WESTERN AUSTRALIA VZ USER GROUP 

GRAEME BYWATER PO BOX 388 MORLEY WA 6062 
BRISBANE VZ USERS WORKSHOP ~ C/O 63 TINGALPA ST. WYNUM WEST 4178 
SOFTWARE FOR SALE - DISK MENU 


SAPPHIRE PRODUCTIONS - VZ DISK MAGAZINE - PUBLIC DOMAIN 
NOTE =: VZ DISK MAGAZINE HAS CEASED PRODUCTION 
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NOTE : WHEN WRITING TO ANY ABOVE OR H.V.VZ. USERS’ GROUP FOR INFORMATION 
PLEASE ENCLOSE A S.S.A.E. OR NZ 2 INT. REPLY COUPONS. 





